Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Application-Defined Functions / Message Override Function for the Printing Status Dialog Box

GXJobStatus

QuickDraw GX sends the gxJobStatus message to display the current status of a print job during spooling and despooling. You can install an override function for the gxJobStatus message to prevent the display of status information during spooling. Your override function must match the following formal declaration:

OSErr GXJobStatus (gxStatusRecord *aStatusRecord);

aStatusRecord

A pointer to a status structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the gxJobStatus message when a printing extension or printer driver calls the GXReportStatus function. This is not under the application's control.

The default implementation of this message displays the status in the desktop printer window. To prevent the display of the Printing Status dialog box, your override function should return noErr as its only action.

SPECIAL CONSIDERATIONS

You never send the gxJobStatus message yourself.

You must forward the gxJobStatus message to other message handlers.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The status structure is described in the section "The Status Structure" on page 4-42.

For more information about status information, see the printing functions chapter of Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help